home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / bbs_util / transx11.zip / TX.DOC < prev    next >
Text File  |  1996-05-22  |  50KB  |  1,155 lines

  1.  
  2.                                                         ▄▄     ▄▄
  3.            ▀▀▀▀█▀▀▀▀ █▀▀▀▀▀▀▄ ▄▀▀▀▀▀▀▄ █▄     █ █▀▀▀▀▀▀  ▀█▄ ▄█▀
  4.                █     █▀▀▀▀▀▀▄ █▀▀▀▀▀▀█ █ ▀▀▄▄ █ ▀▀▀▀▀▀█    ▐█▌
  5.                █     █      █ █      █ █     ▀█ ▄▄▄▄▄▄█  ▄█▀ ▀█▄
  6.                                                        ▄█▀     ▀▀
  7.                                                      ▄█▀  v1.1
  8.            Internet/Fidonet Transporter            ▄█▀
  9.            Copyrighted Multiboard Communications Centre, 1995-1996
  10.            All rights reserved                 ▄█▀
  11.                                              ▄█▀
  12.  
  13. ╓────────────────────────────────────────────────────────────────────────────╖
  14. ║  Introduction                                                              ║
  15. ╙────────────────────────────────────────────────────────────────────────────╜
  16.  
  17.    What is it?
  18.  
  19.      ■ An inexpensive solution to the high cost of running long-distance
  20.        fidonet comaptible connections.
  21.  
  22.      ■ Transx is, in essence, a fidonet mail tosser that uses internet
  23.        email as a transfer medium rather than requiring you to call the
  24.        remote system directly to transfer mail.
  25.  
  26.    Is it secure?
  27.  
  28.      ■ It has integrated error checking, and loss prevention methods,
  29.        as well as security features to ensure the safe unaltered delivery
  30.        of your mail.
  31.  
  32.    How does it work?
  33.  
  34.      ■ What it does is scan through your netmail directory, looking for
  35.        mail destined to sites you have setup in your connections list.
  36.        Upon finding any, it will encode the mail and any attached files
  37.        and send them to the remote site via email.  The remote site would
  38.        then use Transx to decode these messages back into their original
  39.        state, just as if you had called directly and dropped them off.
  40.  
  41.    How much work is it to run and maintain?
  42.  
  43.      ■ Once setup, this send and receive transfer process is fully
  44.        automated and runs much like your echomail processor does.
  45.  
  46.  
  47. ╓───────────────────────────────────────────────────────────────────────────╖
  48. ║ Installing                                                                ║
  49. ╙───────────────────────────────────────────────────────────────────────────╜
  50.  
  51.    Installing Transx couldn't be simpler.
  52.  
  53.     1) Simply extract the archived package into the directory you
  54.        wish to keep Transx.  (It is HIGHLY suggested you choose a new
  55.        directory for this, since it will create two subdirectories of
  56.        its own)
  57.  
  58.     2) Run TXSETUP.EXE, it will give you the option of running quick
  59.        setup, or if you choose not to use the quick setup, the setup
  60.        program will continue normally and allow you to manually
  61.        edit the information.
  62.  
  63.    Now you need to integrate it with your current email system.  If you
  64.    are using a direct UUCP connection then follow the UUCP Install
  65.    instructions, otherwise skip down to the netmail install instructions.
  66.  
  67.    UUCP Install
  68.  
  69.     ■ This is the easiest and most efficient method of running Transx,
  70.       as Transx can directly read/write to your UUCP spool bypassing
  71.       any netmail conversion steps.
  72.  
  73.     ■ Here are the important things to do when setting up the UUCP.
  74.  
  75.         1) Run TX.EXE in an event periodically to make sure that
  76.            is run often.  Optionally you could place it in the batch
  77.            file you use to call your internet provider.
  78.  
  79.            For example:  TX.EXE /NOIMPORT
  80.                          DIALUUCP
  81.                          TX.EXE /NOEXPORT
  82.  
  83.            ..would be a pretty efficient way to run Transx.
  84.  
  85.         2) Make sure that messages to "transx@yoursite.com" are
  86.            never imported into your BBS.  If for some reason Transx
  87.            misses a message (due to network error, or file locking)
  88.            and your internet email tosser imports the mail for Transx
  89.            into your BBS, then Transx will never be able to process
  90.            that message since it will be removed from the spool after
  91.            it was imported to your BBS.
  92.  
  93.            If you are using NetXpress you could prevent this by
  94.            running Transx from a SERVICES.IN setting..
  95.  
  96.            SETUP.EXE -> Configuration -> Special Files -> SERVICES.IN
  97.  
  98.            ┌ Special File: SERVICES.IN ───────────────────────────────
  99.            │ Service Name                 Batch Filename
  100.            ├──────────────────────────────────────────────────────────
  101.            │ transx                       m:\transx\tx.exe
  102.            │
  103.  
  104.            Almost all internet tossers should have some sort of option
  105.            to hold the importing of a message into your BBS, or to run
  106.            a service when it sees mail to a certain user. Consult your
  107.            UUCP mail processor documentation if required.
  108.  
  109.  
  110.    Netmail Install
  111.  
  112.     ■ This method allows compatibility with almost every fidonet
  113.       compatible system that uses netmail for it's internet email.
  114.       Either this mail is processed by a netmail/email converter
  115.       on your site, or perhaps from a local provider.
  116.  
  117.     ■ Here are the important things to do when setting up..
  118.  
  119.         1) Run TX.EXE in an event periodically to make sure that
  120.            is run often.  Putting it in your "Mail Received" batch
  121.            file is not usually sufficient for most systems, since
  122.            if you do not receive mail for a while, Transx will not
  123.            be run, and your mail will not be exported via Transx.
  124.  
  125.            One solution is to add it to your nightly maintenance
  126.            batch file in addition to placing it in your "Mail Received"
  127.            batch file to ensure that it is run at least once a day.
  128.  
  129.         2) Make sure that messages to "Transx" are never imported into
  130.            your BBS.  If for some reason Transx misses a message (due
  131.            to network error, or file locking) and your internet email
  132.            tosser imports the mail for Transx into your BBS, then Transx
  133.            will never be able to process that message since it will be
  134.            removed from the spool after it was imported to your BBS.
  135.  
  136.            The best way to do this is by going into your echomail
  137.            tosser and adding "Transx" as a user, and then specifying
  138.            your echomail tosser to not import mail for this user
  139.            into your netmail directory.
  140.  
  141.            For GEcho, you can do it like this:
  142.  
  143.            GSETUP.EXE -> System Data -> System Users
  144.  
  145.            ╒═════════════════════════════════════════════════════  2 ╕
  146.            │                                                         │
  147.            │ SysOp name          Transx                              │
  148.            │ Personal mail area  0                                   │
  149.            │ Use AKA area        No                                  │
  150.            │ Netmail area        0   <----------------------------------
  151.            │                                                         │
  152.            ╘═════════════════════════════════════════════════════════╛
  153.  
  154.            For FastEcho, you can do it like this:
  155.  
  156.            FESETUP.EXE -> System -> Users
  157.  
  158.            ╔════════════════ Users ════════════════╗
  159.            ║    Name                               ║
  160.            ╟───────────────────────────────────────╢
  161.            ║  1 Pete Rocca                         ║
  162.            ║  2 Transx     <--------------------------------------------
  163.            ║  3                                    ║
  164.  
  165.            ..and..
  166.  
  167.            FESETUP.EXE -> System -> FEUTIL parameters
  168.  
  169.            ┌───── FEUTIL parameters ────┐
  170.            │ PURGE - Messages         0 │
  171.            │         Days             0 │
  172.            │         Rcvd Days        0 │
  173.            │ Use arrival date       Yes │
  174.            │ Autorenumber at          0 │
  175.            │ Exclude Users          Yes │
  176.            │ Exclude SysOps         Yes │ <-----------------------------
  177.  
  178.            For FastEcho both of the above have to be active.
  179.            If you still wish to have your personal mail imported
  180.            into the BBS netmail rather than left in the netmail
  181.            directory, you can remove your name from the list of
  182.            "Users" and FEUTIL Import will import your mail but
  183.            leave Transx mail alone.
  184.  
  185.            Also, if you are running iServer, you can incorporate
  186.            an Infobot to run Transx when mail comes in for it..
  187.  
  188.            ISERVCFG.EXE -> Infobot Response System
  189.  
  190.                ╔══╡ Infobot Response System ╞═════════════════════════
  191.                ║
  192.                ║  TRANSX                     Delay   M:\TRANSX\TX.EXE
  193.            ╔══╡ Edit ╞═════════════════════════════════════════════╗
  194.            ║                                                       ║
  195.            ║  Trigger : TRANSX                                     ║
  196.            ║  Type    : Delay run                                  ║
  197.            ║  File    : M:\TRANSX\TX.EXE /NOEXPORT                 ║
  198.            ║  Subject :                                            ║
  199.            ║                                                       ║══
  200.            ╚═══════════════════════════════════════════════════════╝
  201.  
  202.            Ensure that you have iServer setup for "Delay run", as if
  203.            you have it set for "Run program", you will lose mail due
  204.            to type of interaction required.
  205.  
  206.            Even if you are using iServer, it is a good idea to make
  207.            sure that you use the GSETUP/FESETUP method to make sure
  208.            that your mail is 100% safe from being imported to the
  209.            BBS accidentally.
  210.  
  211.  
  212. ╓────────────────────────────────────────────────────────────────────────────╖
  213. ║  TX.EXE - The main program                                                 ║
  214. ╙────────────────────────────────────────────────────────────────────────────╜
  215.  
  216.    TX is the program that you run in order to process the inbound and
  217.    outbound mail for Transx.
  218.  
  219.    There are a number of command line parameters that you can use to
  220.    change aspects of the default properties, or to run statistical
  221.    tools and informational reports.  To run it in normal mode, no
  222.    command line parameters are required.
  223.  
  224.     ■ Commands and options
  225.  
  226.       /NOEXPORT   -   Do not encode outbound mail
  227.       /NOIMPORT   -   Do not decode inbound mail
  228.       /NOLOGO     -   Disable the Transx logo upon startup {+}
  229.       /NOAUTO     -   Disable automaintenance
  230.       /MAINT      -   Force maintenance
  231.       /STATS      -   Display current traffic statistics
  232.  
  233.     ■ Queue reporting and management
  234.  
  235.       /DETAIL     -   List a detailed report on queued/held messages
  236.       /SUMMARY    -   List a summary report on queued/held messages
  237.       /KILL       -   Delete the queued/held messages
  238.       /EXPIRE     -   Expire the queued/help messages
  239.  
  240.                       Modifiers /FOR:[user] and /FILE:[filespec] can also be
  241.                       used to limit the processing on only matching criteria
  242.  
  243.                       For example, to expire all held messages for a
  244.                       connection at "transx@remote.sys" you could use
  245.                       something like "TX /EXPIRE /FOR:remote.sys"
  246.  
  247.    For more information about how and where to run TX.EXE from, please
  248.    refer back to the "Installing" section of the documentation.
  249.  
  250.  
  251. ╓────────────────────────────────────────────────────────────────────────────╖
  252. ║  TXSETUP.EXE - The setup and configuration program                         ║
  253. ╙────────────────────────────────────────────────────────────────────────────╜
  254.  
  255.    TXSETUP is a fully windowed setup program with a complete online manual
  256.    to help you get things running with as much ease as possible.  The
  257.    setup program has the following main options...
  258.  
  259.  
  260.    General Information
  261.  └─────────────────────────────────────
  262.  
  263.    Sysop
  264.  
  265.      ■ This is where you put your name, or the name of the person who will
  266.        be administering Transx on your system.  This name is used in coding
  267.        and for report generating.
  268.  
  269.    System name
  270.  
  271.      ■ This is where you put your system name which is used in identifying
  272.        your system, and writing organization information in the UUCP spools.
  273.  
  274.    Domain
  275.  
  276.      ■ This is your internet domain address, it is used both for the
  277.        sending and receiving of mail, as well as a used in creating unique
  278.        message identification lines.
  279.  
  280.    Site address
  281.  
  282.      ■ This is the netmail address that inbound internet email messages
  283.        are addressed to.  If you are using the direct UUCP spool options,
  284.        then just use your main system netmail address.
  285.  
  286.    Site address .. Aka
  287.  
  288.      ■ For the best integration with your current mail setup, it is
  289.        quite important that you enter all of your system aka addresses
  290.        here.  These addresses are used to determine which messages to
  291.        classify as "InTransit"
  292.  
  293.    Gate address
  294.  
  295.      ■ This is the outbound address that you send your internet email
  296.        to.  For example, if you send your outbound email to 1:2401/305.5,
  297.        then place this address in here.  If you are using the direct UUCP
  298.        spool options, then just use 0:0/0.
  299.  
  300.    Gate netflags
  301.  
  302.      ■ Here you can specify the netmail flags that outbound translated
  303.        mail addressed to your UUCP host should have.  Kill/Direct is a
  304.        common standard.
  305.  
  306.    Robot name
  307.  
  308.      ■ This is the robot name that Transx will look for incoming mail to
  309.        be addressed to.  The given standard is "transx" but if you require
  310.        to change it, you may do so here.
  311.  
  312.      ■ This name is used in conjunction with your domain name and should be
  313.        used by your connections as the Transx address to send to.
  314.  
  315.      ■ For example a domain name of "yoursite.com" and robot name of
  316.        "transx" would give you a Transx address of "transx@yoursite.com"
  317.  
  318.        This address would be what your other connections would use to
  319.        export their outbound mail to.
  320.  
  321.    Serial and Registration
  322.  
  323.      ■ This is where you put your serial and registration numbers once you
  324.        have registered this package.
  325.  
  326.  
  327.    File and Path Configuration
  328.  └─────────────────────────────────────
  329.  
  330.    Log file
  331.  
  332.      ■ Here you can define the log file you wish to have updated with
  333.        logged information.  If you do not wish to have a log file, simply
  334.        leave this field blank.
  335.  
  336.    Netmail path
  337.  
  338.      ■ This is where your *.MSG files are located.  This will be the
  339.        directory that is scanned for outgoing mail waiting to be
  340.        converted and sent via Transx.
  341.  
  342.      ■ Also, if you are not using an advanced spool, Transx will use
  343.        this path to create it's outbound *.MSG files, destined to your
  344.        UUCP gateway.
  345.  
  346.    Update semaphore
  347.  
  348.      ■ These are files that you can update or "touch" when Transx has
  349.        modified the netmail directory.  They are typically good for
  350.        causing other tasks to rescan the modified messages.
  351.  
  352.        For example...
  353.  
  354.        M:\FD\FDRESCAN.NOW  (FrontDoor)
  355.        M:\DB\DBRIDGE.RSN   (D'Bridge)
  356.  
  357.    Secure inbound
  358.  
  359.      ■ This is the directory to place inbound files that were decoded and
  360.        included a secure envelope.  A secure password can be configured
  361.        in the Connection Manager section of the setup program.  Inbound
  362.        files can include file attaches and inbound echomail bundles.
  363.  
  364.      ■ The secure setting is much like the "Secure session" that you
  365.        can establish between mailers.
  366.  
  367.    Insecure inbound
  368.  
  369.      ■ This is the directory to place inbound files that had a valid
  370.        envelope, but not listed as secure.
  371.  
  372.    Violation inbound
  373.  
  374.      ■ This is the directory to place inbound files that did not have
  375.        a valid envelope, or had an unexpected or incorrect secure
  376.        password used.
  377.  
  378.      ■ It will also be the directory that files are moved into if the
  379.        message had a valid insecure envelope, but you have the system
  380.        marked as "Secure inbound only" in the Connection Manager setup.
  381.  
  382.  
  383.    Default Options
  384.  └─────────────────────────────────────
  385.  
  386.    Send acknowledgments
  387.  
  388.      ■ If you wish to send acknowledgments to remote sites not in your
  389.        Connection Manager that send you mail, then select yes.
  390.  
  391.      ■ It is a good default to send receipts if you do not know if the
  392.        remote site needs them, since if they are not required by the
  393.        remote site, it will simply discard them.
  394.  
  395.    Send acknowledgments .. Expiry hours
  396.  
  397.      ■ This expiry setting determines how many hours you should keep
  398.        parts of inbound files that are not yet completed before assuming
  399.        the missing parts were lost and requesting a resend from the
  400.        remote site.
  401.  
  402.      ■ Note that this value should be kept fairly small to ensure that
  403.        you do not have mail lags if a part ever goes missing, however it
  404.        should not be so short that it prematurely submits a resent request
  405.        while the parts may be still in transit.  A setting of 24 hours is
  406.        probably sufficient for most systems.
  407.  
  408.    Accept resend requests
  409.  
  410.      ■ If you wish to hold on to sent mail for a number of days in order
  411.        for the remote site to be able to re-request failed packages, or
  412.        for auto-resending, then select yes.  This setting applies to
  413.        nodes that are not in your Connection Manager already, in which
  414.        case the Accept resend requests there will override this setting.
  415.  
  416.    Accept resend requests .. Expiry hours
  417.  
  418.      ■ This expiry value determines how many hours to keep mail held
  419.        incase of a remote resend request.  Once mail has expired this
  420.        time setting, it will be deleted.
  421.  
  422.      ■ Note that if this value is too short, some systems with slower
  423.        UUCP connections may not send a resend request before you expire
  424.        the mail.  This value should typically be at least one day longer
  425.        than the remote's Send acknowledgments expiry hours.
  426.  
  427.    Auto resend unacked mail
  428.  
  429.      ■ If you wish to, by default, automatically resend mail packets that
  430.        you have not received an acknowledgment for, then select yes.  This
  431.        setting is usually best left off since you do not know if unknown
  432.        sites (not listed in your Connection Manager) will be sending
  433.        you acknowledgment receipts.
  434.  
  435.    Auto resend unacked mail .. Max resends
  436.  
  437.      ■ You can restrict the number of times any given message is resent
  438.        from your system.  This includes the remote re-requesting the mail
  439.        and auto resends if setup.
  440.  
  441.      ■ This is can be used for either of two reasons, the first being
  442.        that you might not want a site to become reliant on requesting
  443.        the package 10 or 20 times just because they are losing packets
  444.        due to setup or human problems, and it can also be used to stop
  445.        endless resend loops if the remote system never sends an
  446.        acknowledgment for the package.
  447.  
  448.    Decode stray inbound mail {+}
  449.  
  450.      ■ You can have Transx decode mail addressed to your robot name even
  451.        when the remote site is not in your connections list.  If mail of
  452.        this type is decoded, it takes its properties from the Default
  453.        Options configuration.
  454.  
  455.      ■ If you set this to "No" then sites not listed in your connections
  456.        will not be able to send you Transx mail.
  457.  
  458.    Max length
  459.  
  460.      ■ This is the maximum length of each part of a multi-part file.  For
  461.        example, if you were sending a 100,000 byte file, and had this
  462.        value at 30,000 bytes, it would send 4 parts to complete the file.
  463.  
  464.      ■ This value MUST be smaller than the smallest split point in the
  465.        path between your system and the remote system.
  466.  
  467.        For example...
  468.  
  469.        If you were sending mail from site A to site C through site B,
  470.        and site B's gateway splits messages at 30,000 bytes and site C
  471.        splits messages at 40,000 bytes you would have to pick a number
  472.        30,000 bytes or less.
  473.  
  474.      ■ Very important!
  475.  
  476.        In other words, if any package other than Transx resplits the
  477.        messages into smaller parts, the receiving Transx program will
  478.        not be able to reconstruct the original message.
  479.  
  480.      ■ Default
  481.  
  482.        A good default is 15000 bytes or less, since it is the smallest
  483.        default setting of any gateway that we currently know about.  If
  484.        you are setting up a connection with another site you can
  485.        negotiate a higher setting for better efficiency, but for sites
  486.        that you are not sure about (ones not in your connection table)
  487.        using the 15000 byte setting is the best bet.
  488.  
  489.        If you get an error saying "? Invalid message; reason = 4" then
  490.        chances are pretty good that the message was resplit by a gateway.
  491.  
  492.  
  493.    Log Options
  494.  └─────────────────────────────────────
  495.  
  496.      ■ You can specify how much information is written to the log file
  497.        by toggling the Yes/No setting for each category.
  498.  
  499.      ■ The "Debug logging" option enables all the logging levels as well
  500.        as logging skipped messages, and additional debug info to help
  501.        isolate any problems you might encounter.
  502.  
  503.  
  504.    Advanced Options
  505.  └─────────────────────────────────────
  506.  
  507.    Kill empty inbound file attach messages
  508.  
  509.      ■ If you wish to delete inbound messages that are empty, rather
  510.        than leave it in your netmail folder, select yes.  These types of
  511.        messages are typically for file attaching echomail bundles, and
  512.        are normally removed by your mailer.
  513.  
  514.    Export messages marked Crash/Immediate
  515.  
  516.      ■ You may not want to translate outbound mail with Crash/Immediate
  517.        status flags.  If you do wish to export them regardless of these
  518.        settings, select yes.
  519.  
  520.    Export messages marked Freq/Ureq
  521.  
  522.      ■ You may not want to translate outbound mail with Freq/Ureq
  523.        status flags.  If you do wish to export them regardless of these
  524.        settings, select yes.
  525.  
  526.    Export messages marked Hold
  527.  
  528.      ■ Normally messages marked as "Hold" will not be sent, however if
  529.        you wish to override this setting, select yes.
  530.  
  531.    Send sysop notification on bad packets
  532.  
  533.      ■ When a bad package is received, you can have Transx post you a
  534.        message containing as much of the failed message as possible and,
  535.        if available, the file that was attached.
  536.  
  537.      ■ If you have request receipts enabled, the package will be requested
  538.        again from the remote site regardless of this setting.
  539.  
  540.    Advanced spool .. Type
  541.  
  542.      ■ Transx has the ability to increase efficiency by supporting different
  543.        file formats for your messages.  This allows you to bypass many
  544.        steps required to send internet email depending on how your system
  545.        is configured.
  546.  
  547.      ■ By default Transx uses the *.MSG format for both inbound and
  548.        outbound mail.  Messages destined to the internet are simply
  549.        addressed to the gateway address specified in the General
  550.        Information section, and left for your gateway/tosser/packer
  551.        to deal with.
  552.  
  553.        However, if you are running the gateway yourself (rather than
  554.        using a remote fidonet compatible system to transfer email) you
  555.        can bypass a number of steps that are typically required to
  556.        process internet email from a fidonet system.
  557.  
  558.        There are three types supported by Transx...
  559.  
  560.        None  This is the standard method for delivering email via
  561.              a netmail format to the internet and not considered
  562.              to be an Advanced Spool.
  563.  
  564.              Outbound mail..
  565.  
  566.              Your system     (*.MSG) Netmail destined to gateway address
  567.              Fido tosser     (*.PKT) Compressed packet
  568.              Gateway         (*.DAT) UUCP -> Internet
  569.  
  570.              Inbound mail..
  571.  
  572.              Gateway         (*.D/X) Internet -> UUCP
  573.              Fido tosser     (*.PKT) Compressed packet
  574.              Your system     (*.MSG) Netmail from gateway address
  575.  
  576.        PKT   This is similar to the above routine, except with
  577.              outbound mail, it skips the *.MSG step, and directly
  578.              creates the compressed packets (*.PKT) for your gateway
  579.              program to export, saving your echomail tosser from
  580.              having to do that job.
  581.  
  582.        UUCP  This is the most efficient method for using Transx if
  583.              you have a direct UUCP feed.  It bypasses all the
  584.              conversion steps and reads/writes directly to your
  585.              UUCP spool directory.  If you have a direct UUCP feed
  586.              it is highly recommended to use this spool type.  If
  587.              you are using this method, no 3rd party utilities
  588.              other than your UUCICO transfer program are required
  589.              to use Transx.
  590.  
  591.        SMTP  This is the most efficent method for using Transx if
  592.              you have a direct SMTP server.  It bypasses all the
  593.              conversion steps and reads/writes directly to your
  594.              SMTP spool directory.
  595.        
  596.    Advanced spool .. Path
  597.  
  598.      ■ If you are using the Advanced Spool Type of PKT Type 2+, then
  599.        this should be the directory that your gateway program looks for
  600.        *.PKT files to export.
  601.  
  602.      ■ If you are using the Advanced Spool Type of UUCP (In/Out) then
  603.        this should be the UUCP spool directory for your site.  Note that
  604.        this is NOT the spool root directory, rather the actual path that
  605.        the *.D/*.X files can be located, as well as the correct path to
  606.        write outbound *.DAT/*.XQT/*.CMD files.
  607.        
  608.      ■ If you are using the Advanced Spool Type of SMTP then the in and
  609.        out paths defined should match the paths used by your SMTP server.       
  610.  
  611.    UUCP options .. Site name
  612.  
  613.      ■ If you are using the advanced UUCP spool, then this is your site
  614.        name as your UUCP host knows you.  This is not always the same
  615.        name as your domain name, and should match the "uucpname" setting
  616.        in your UUCICO transfer program.
  617.  
  618.    UUCP options .. Host name
  619.  
  620.      ■ If you are using the advanced UUCP spool, then this is your UUCP
  621.        hosts name.  This is not always the same name as their domain
  622.        name, and should match the "hostname", "dialing name" or "remote
  623.        name" setting in your UUCICO transfer program.
  624.  
  625.    UUCP options .. Time zone
  626.  
  627.      ■ This is your difference in time from UTC.  This is used in the
  628.        generation of time stamps for outbound UUCP mail.  The time is
  629.        usually plus or minus the number of hours and minutes in the
  630.        HHMM format.
  631.  
  632.        For example...
  633.  
  634.        If you are in the Eastern Standard Time zone (which is UTC
  635.        minus 5 hours), then the value should be -0500.
  636.  
  637.        You can also override the value that gets placed as the time
  638.        zone when posting the packets, by setting the TZ or TZUTC
  639.        environment varibles.  This is designed to make configuration
  640.        easier for those locations in which the time zone varies during
  641.        the year.
  642.  
  643.    Notes...
  644.  
  645.      ■ If you are not running a gateway yourself, rather calling out
  646.        to another system to deliver netmail-style internet messages,
  647.        then you MUST use the setting "None" for Advanced Spool Type.
  648.  
  649.  
  650.    Connection Manager
  651.  └─────────────────────────────────────
  652.  
  653.    This is where you define your "Connections" whom with you will be using
  654.    Transx to communicate with.  This is remarkably similar to setting up
  655.    your connections in your echomail tosser.
  656.  
  657.    How do you know who to send to?  Well, that's a lot like asking, where
  658.    should I address my postal mail? or where do I drive to work?
  659.  
  660.    Your connections will depend on who you talk with, and who else wishes
  661.    to run a Transx connection with you - it is something you setup within
  662.    your network of contacts.
  663.  
  664.    For example, if you talked a great deal with someone long distance to
  665.    you, and you both had email running on your board, you could both
  666.    arrange to run Transx and exchange your connection info.  You would
  667.    then be able to eliminate your long distance between the two of you,
  668.    saving both of you lots of money.
  669.  
  670.    Also, you can now take part in smaller fidonet style networks across
  671.    the world, that would have been impractical or costly to do so before.
  672.    Or if you host a network, here is your chance to make it international
  673.    since it wouldn't cost your downlinks anything to carry it!
  674.  
  675.    Another method of getting Transx contacts, is to spread the word about
  676.    Transx, perhaps add your Transx address in your signature file.  The
  677.    more people that have your address, the more can send to you, and you
  678.    in return can get their information and send to them.
  679.  
  680.  
  681.    Editing a Connection
  682.  └─────────────────────────────────────
  683.  
  684.    Sysop
  685.  
  686.      ■ This is the name of the sysop/adminstrator at the remote site.
  687.  
  688.    Network address
  689.  
  690.      ■ This is the network address of the site that you will be sending
  691.        to.  Any netmail messages found in your *.MSG directory to this
  692.        address will be considered for Transx export.
  693.  
  694.    Transx address
  695.  
  696.      ■ This is the email address of the Transx receiver on the remote
  697.        system.  (this is not the email address of the administrator of
  698.        the remote site, rather the address which answers the Transx mail)
  699.  
  700.      ■ For information regarding "robot name" please reference the help
  701.        in the General Information setup screens.
  702.  
  703.    Password
  704.  
  705.      ■ If you wish to have a secure envelope added to the message, you can
  706.        do so by specifying a password here.  A secure envelope means that
  707.        the contents of the message have not been altered during transport.
  708.        Both you and the receiver will have to use the same password or
  709.        you will receive "Invalid password" notices.
  710.  
  711.    Max length
  712.  
  713.      ■ This is the maximum length of each part of a multi-part file.  For
  714.        example, if you were sending a 100,000 byte file, and had this
  715.        value at 30,000 bytes, it would send 4 parts to complete the file.
  716.  
  717.      ■ This value MUST be smaller than the smallest split point in the
  718.        path between your system and the remote system.
  719.  
  720.        For example...
  721.  
  722.        If you were sending mail from site A to site C through site B,
  723.        and site B's gateway splits messages at 30,000 bytes and site
  724.        C splits messages at 40,000 bytes you would have to pick a number
  725.        30,000 bytes or less.
  726.  
  727.      ■ Very important!
  728.  
  729.        In other words, if any package other than Transx resplits the
  730.        messages into smaller parts, the receiving Transx program will not
  731.        be able to reconstruct the original message.
  732.  
  733.    Translate outbound
  734.  
  735.      ■ If you wish to use Transx to export outbound messages to this
  736.        site, select yes.  If you wish to only accept inbound from this
  737.        site, or wish to suspend mail for a short period, you can disable
  738.        translating outbound mail.
  739.  
  740.    Translate inbound
  741.  
  742.      ■ If you wish to decode inbound mail from this node, then select yes
  743.        here.  If you do not want to decode inbound Transx messages for any
  744.        reason, you can do so by selecting no.
  745.  
  746.    Secure only
  747.  
  748.      ■ If you have a secure session password with this remote node, and
  749.        wish to flag messages that are not password encoded as "Invalid
  750.        password", then select yes, otherwise mail will be processed normally
  751.        whether the remote site is using the password or not.
  752.  
  753.    Send acknowledgments
  754.  
  755.      ■ If you wish to send acknowledgments to the remote site when you
  756.        receive your mail, then select yes.  This should usually match the
  757.        remote setting for "Accept resend requests"
  758.  
  759.      ■ You can also select "Batch" which means that multiple receipts
  760.        to the same site in the same session will be sent in one message
  761.        rather than a single message per receipt.
  762.  
  763.    Send acknowledgments .. Expiry hours
  764.  
  765.      ■ This expiry setting determines how many hours you should keep
  766.        parts of inbound files that are not yet completed before assuming
  767.        the missing parts were lost and requesting a resend from the
  768.        remote site.
  769.  
  770.      ■ If set to zero then it will take the value from the "Default Options"
  771.        setting.  This field is great if you need to have different expiry
  772.        hour settings for different nodes.
  773.  
  774.    Accept resend requests
  775.  
  776.      ■ If you wish to hold on to sent mail for a number of days in order
  777.        for the remote site to be able to rerequest failed packages, or
  778.        for auto-resending, then select yes.  This setting should usually
  779.        match the remotes "Send acknowledgments" setting.
  780.  
  781.    Accept resend requests .. Expiry hours
  782.  
  783.      ■ This expiry value determines how many hours to keep held mailing
  784.        waiting before expiring it.
  785.  
  786.      ■ If set to zero then it will take the value from the "Default Options"
  787.        setting.  This field is great if you need to have different expiry
  788.        hour settings for different nodes.
  789.  
  790.    Auto resend unacked mail
  791.  
  792.      ■ If you wish to automatically resend mail packets that you have not
  793.        received an acknowledgment for, then select yes.  You should only
  794.        use this setting if you have "Accept resend requests" turned on and
  795.        the remote system is sending you acknowledgments.
  796.  
  797.    Notes...
  798.  
  799.      ■ The acknowledgment/resend features of Transx allows you to ensure
  800.        safe mail delivery over the internet without little or no chance of
  801.        any problems or mail loss along the way.
  802.  
  803.      ■ If both systems are using the acknowledgment/resend features, you
  804.        know that mail will be resent if it doesn't get acknowledged by the
  805.        other side.  You may, however, decide that the mail is either not
  806.        important enough, or that your link is secure enough to not require
  807.        to use these features to ensure safe mailing.
  808.  
  809.  
  810.    Routing (Commercial version only)
  811.  └─────────────────────────────────────
  812.  
  813.      ■ Transx has the ability to route and send mail via another Transx
  814.        user, acting as a Gateway, to another site who may not have Transx
  815.        setup themselves.
  816.  
  817.        For example...
  818.  
  819.        If you were routing all mail to Zone 99 via 99:1/0, you would
  820.        have an entry for your connection with 99:1/0, but in addition,
  821.        you would insert a routing entry of "99:*", which would route
  822.        all mail to Zone 99 to 99:1/0, who would then decode it as normal
  823.        netmail, and deliver it to the intended recipient.
  824.  
  825.        Gateways can forward to other gateways, and so on, which makes
  826.        Transx an excellent method for moving mail quickly and inexpensively.
  827.  
  828.      ■ Transx is "smart" when routing, and will always try to pick the most
  829.        direct connection when routing conflicts are found.
  830.  
  831.        For example...
  832.  
  833.        Say you were sending a message to 99:400/123, and you had two
  834.        connections setup that routed mail to Zone 99...
  835.  
  836.        1) 99:1/0   - that routed mail for 99:*
  837.        2) 99:400/0 - that routed mail for 99:400/*
  838.  
  839.        The message would be Transx sent to 99:400/0 since it contains a
  840.        higher level destination match and is probably physically closer or
  841.        quicker to the destination.
  842.  
  843.      ■ You can also exclude addresses from being routed by placing a minus
  844.        sign before the routing entry.
  845.  
  846.        For example...
  847.  
  848.        You could have the following routing entries:
  849.  
  850.          1) 99:4*
  851.          2) -99:400/*
  852.  
  853.        This would cause all routable messages for 99:4*/* to be routed
  854.        with the exception of messages addressed to 99:400/*
  855.  
  856.      ■ By default, Transx will not route messages with files attached to
  857.        them, however if you if you have a connection that permits you to
  858.        route messages with files through them, you can add the ",F" suffix
  859.        to the route entry..
  860.  
  861.        For example...
  862.  
  863.        You could have the following routing entries:
  864.  
  865.        1) 99:1/*   - would route mail to 99:1/* via the connection
  866.        2) 99:1/*,F - would route mail even with files via the connection
  867.  
  868.    Notes...
  869.  
  870.      ■ Of course there are a few things to keep in mind when setting up
  871.        your routing entries...
  872.  
  873.        * You must have an agreement with the gateway to allow this
  874.        * You must have a connection setup to the gateway
  875.        * The gateway should be closer to the destination than you are
  876.  
  877.      ■ You can qualify a system with an level of address matching.  This
  878.        means that addresses such as Zone:*, Zone:Net/*, Zone:Net/Node.* or
  879.        exact address matches are all valid.  When specifying point 0, do
  880.        not include it in the addressing, for example 1:2401/305.0 should
  881.        read "1:2401/305" without the ".0"
  882.  
  883.  
  884. ╓────────────────────────────────────────────────────────────────────────────╖
  885. ║  TXUTIL.EXE - The utility program                                          ║
  886. ╙────────────────────────────────────────────────────────────────────────────╜
  887.  
  888.    Included with the commercial version of Transx is TXUTIL, a program which
  889.    allows you to view and/or alter the settings of queued Transx packets.
  890.    Below is a list of features available in the utility program.
  891.  
  892.        ALT-D - Delete this package
  893.        ALT-E - Expire this package
  894.        ALT-Q - Requeue this package into the netmail directory
  895.        ALT-R - Send request for remote to resend this package
  896.        ALT-A - Send receipt acknowledging this package
  897.  
  898.        F10   - Rescan packages
  899.        ALT-N - Sort packages by remote address
  900.        ALT-T - Sort packages by expiry time
  901.  
  902.        T     - Tag all packages
  903.        U     - Untag all packages
  904.        SPACE - Toggle package tag status
  905.        ?     - Description of flag settings
  906.  
  907.    Notes...
  908.  
  909.      ■ The shareware version of this utility program only allows you to
  910.        view the message and message settings, you will not be allowed
  911.        to modify the message settings.
  912.  
  913. ╓────────────────────────────────────────────────────────────────────────────╖
  914. ║  Common Questions                                                          ║
  915. ╙────────────────────────────────────────────────────────────────────────────╜
  916.  
  917.    Q) What do I need to run it?
  918.  
  919.       * You'll need to be able to have either a UUCP account or be
  920.         able to receive email as netmail messages via some type of
  921.         email gateway.
  922.  
  923.       * In order for communication with another system, they too
  924.         will be required to be running the Transx package.
  925.  
  926.    Q) How does it work?
  927.  
  928.       * Basically it scans your netmail folder for outgoing mail
  929.         to another Transx site, it encodes the mail and sends it
  930.         along with security and confirmation information as email.
  931.  
  932.       * It is received on the other end and decoded back into its
  933.         original format, whether it would be netmail, echomail or
  934.         file attaches..
  935.  
  936.       * If mail is lost or damaged in transit, it can automatically
  937.         recover by the use of acknowledgement receipts.
  938.  
  939.    Q) It is not sending out mail to one of my connections?
  940.  
  941.       * Make sure that the message does not have the Lock/Hold status
  942.         flags, or if it has the Crash/Immediate flag, make sure that
  943.         you have TXSETUP configured to allow the exporting of immediate
  944.         mail in the Advanced Options section.
  945.  
  946.       * Make sure that you have "Translate Outbound = Yes" setup for
  947.         this system in the Connection Manager.
  948.  
  949.    Q) What do the status numbers mean when doing a /SUMMARY report?
  950.  
  951.       * If you do a /DETAIL report, it will give you a text description
  952.         for the status number, however here is a breakdown of what
  953.         the numbers mean if you do not want to do the /DETAIL report.
  954.  
  955.         #   Error           Cause
  956.        ─── ─────────────── ────────────────────────────────────────────
  957.         0   None            No error has occurred
  958.         1   File error      Could not find file attach (export)
  959.                             Could not create new file  (import)
  960.         2   Write error     Error occurred when writing new file
  961.         3   Bad message     Message body was corrupted
  962.         4   Bad segment     File segment data was corrupted
  963.         5   No message id   Inbound message was missing an id tag
  964.  
  965.    Q) How large can the files be that Transx will send?
  966.  
  967.       * Transx can split and transfer any file in upto 1295 pieces,
  968.         therefore if you are using a max length of 60000 bytes then
  969.         the maximum file size you could send in a single file would
  970.         be roughly 70 megabytes.
  971.  
  972.    Q) Do I have to add TX /MAINT to my nightly maintenance?
  973.  
  974.       * You can run TX /MAINT as often as you like, however if you
  975.         don't run it for more then 24 hours, TX will perform maintenance
  976.         the next time it is run, so no, it is not required, but you
  977.         can if you want to make sure it is only run at a certain time.
  978.  
  979.    Q) Routing doesn't seem to be working, it sees the messages that I
  980.       want to route, but doesn't pack them?
  981.  
  982.       * Make sure you are using the Commercial version.  The Shareware
  983.         version does not support routing.
  984.  
  985.       * Make sure that the messages do not have the Direct, Crash, Hold,
  986.         Immediate, or Lock flags set, messages with any of those status
  987.         flags are not qualified to be routed.
  988.  
  989.       * Make sure that you have a valid routing entry setup with a direct
  990.         connection that matches the destination.  Also make sure that
  991.         this connection is setup to "Translate outbound", otherwise it
  992.         will not be eligible to be a routing host for the message.
  993.  
  994.  
  995. ╓───────────────────────────────────────────────────────────────────────────╖
  996. ║ Support                                                                   ║
  997. ╙───────────────────────────────────────────────────────────────────────────╜
  998.  
  999.    If you have any questions or comments, you can netmail us at FidoNet
  1000.    address 1:2401/305 (CM,V34,VFC).  Please poll back for your replies
  1001.    as we get dozens of messages a day or optionally make a note that you
  1002.    would like your message routed back to you.  You can also contact us
  1003.    via the internet for faster responses, and directly sent out replies.
  1004.    The address is "support@multiboard.com"
  1005.  
  1006.    You can also find us in the RA_UTIL echo conference, as well as the
  1007.    MCC_SUPPORT echo of course.
  1008.  
  1009.    The newest MCC software is also available via the internet:
  1010.  
  1011.    http://www.multiboard.com
  1012.    ftp://ra.uti.com/sys/bbs/bbs/mcc
  1013.    ftp://pcmicro.com/4_authors/multiboard
  1014.  
  1015.    You can also "FREQ" the files from us via fidonet at 1:2401/305, our
  1016.    system is online and taking requests 24 hours/day.  The magic name for
  1017.    the newest version is "TRANSX", or freq "CATALOG" for the newest list
  1018.    of our other products.
  1019.  
  1020.    You can help us direct your messages by using the alternative email
  1021.    addresses when posting us mail:
  1022.  
  1023.     (1)  support@multiboard.com      -  general inquiries
  1024.     (2)  sales@multiboard.com        -  registrations/commercial info
  1025.     (3)  suggestions@multiboard.com  -  suggestions
  1026.     (4)  reports@multiboard.com      -  bug reports
  1027.  
  1028.    Thanks for your interest and support!
  1029.  
  1030.  
  1031. ╓───────────────────────────────────────────────────────────────────────────╖
  1032. ║ Registration                                                              ║
  1033. ╙───────────────────────────────────────────────────────────────────────────╜
  1034.  
  1035.    There are two different versions of Transx currently available:
  1036.  
  1037.    1) Shareware
  1038.  
  1039.       The shareware version is nearly identical to the unregistered
  1040.       evaluation version that you are testing, with the exception that
  1041.       it will allow you to have 2 connections instead of 1, as well as
  1042.       eliminate the unregistered notices and delays.
  1043.  
  1044.       This version is excellent for connecting to main Transx hubs to
  1045.       collect mail and files.  If you are planning on having more than
  1046.       two connections, you should consider the Commercial version.
  1047.  
  1048.       To register this version, simply complete the correct registration
  1049.       form for your area and send it to that registration site.
  1050.  
  1051.  
  1052.    2) Commercial/250
  1053.  
  1054.       This commercial version comes with a disk and printed manual.
  1055.       It allows for upto 250 connections, as well as enables both
  1056.       message and file routing capabilities.  It also includes the
  1057.       full-screen detailed queue modification and viewing program.
  1058.  
  1059.       This version is excellent if you plan on routing mail to save
  1060.       you money, or if you plan on connecting to more than 2 systems.
  1061.       Some good examples would be:
  1062.  
  1063.        ■ Network Co-ordinators for fidostyle networks
  1064.        ■ Software authors for their beta teams
  1065.        ■ Companies with internal fidostyle mail systems
  1066.        ■ Leaving yourself free for future expansion
  1067.  
  1068.       The cost for registering the commercial/250 node version is
  1069.       $60 US, and that includes the disk and printed manual.  For
  1070.       information about the closest commercial registration site
  1071.       to you, please contact us at:
  1072.  
  1073.        ■ reginfo-transx@multiboard.com
  1074.  
  1075.           - For a listing of commercial registration sites and other
  1076.             product information.
  1077.  
  1078.        ■ support@multiboard.com
  1079.  
  1080.           - To contact a staff member about a problem or for more
  1081.             information about Multiboard software.
  1082.  
  1083.        ■ Fidonet at 1:2401/305 (V34,CM)
  1084.  
  1085.           - To contact a staff member about a problem or for more
  1086.             information about Multiboard software.
  1087.  
  1088.        ■ Postal at Multiboard Communications Centre
  1089.                    363 Colborne Street, Suite 1501
  1090.                    London, Ontario
  1091.                    N6B 3N3
  1092.  
  1093.  
  1094.    For systems requiring more than 250 connections, please contact us
  1095.    for information about our extended commercial packages.
  1096.  
  1097.  
  1098. ╓───────────────────────────────────────────────────────────────────────────╖
  1099. ║ License and Disclaimer                                                    ║
  1100. ╙───────────────────────────────────────────────────────────────────────────╜
  1101.  
  1102.    "Transx" is NOT free, it is being marketed  under the "try before you
  1103.    buy" or the shareware concept.  You are entitled to use Transx for a
  1104.    period up to thirty (30) days, after which you MUST register or stop
  1105.    using the program.
  1106.  
  1107.    The shareware registration entitles you to use this version of Transx
  1108.    as well as any future versions of the program that may or may not be
  1109.    released, subject to additional licensing conditions which may be
  1110.    attached.
  1111.  
  1112.    The commercial registration entitles you to receive the newest version
  1113.    of Transx and its companion programs, on a disk with a printed manual.
  1114.    Your registration key will always work with minor updates or bug-fix
  1115.    releases. (For example, upgrading from 1.0 to 1.2, but not 1.x to 2.x)
  1116.    Should if after you purchase Transx, a newer major version is released
  1117.    within 30 days, you will be entitled to receive a new registration key
  1118.    free of charge.  If you require to upgrade to the new major version
  1119.    after this period, there will be a small upgrade fee.
  1120.  
  1121.    Registration will also you to use all of the available functions of
  1122.    Transx, and help to continue the development of this program.  (not
  1123.    to mention maintain the legality of this agreement)
  1124.  
  1125.    By running any of the executable programs included, you agree that
  1126.    Pete Rocca, Darryl Olthoff, Multiboard Communications Centre nor any
  1127.    affiliates of the above mentioned are responsible for any damage or
  1128.    loss experienced, however so created.  If you cannot agree to this,
  1129.    then your privilege to use any of these programs is revoked and it
  1130.    becomes illegal for you to execute any programs included with this
  1131.    documentation.
  1132.  
  1133.    You may freely copy and distribute the shareware version of Transx as
  1134.    long as its original archived contents are not modified in any way.
  1135.    You may NOT distribute any registration keys without the expressed
  1136.    written consent of Pete Rocca of Multiboard Communications Centre.
  1137.    You may not use a registration key that is not licensed to you by
  1138.    Pete Rocca, or any of the registration sites appointed by Pete Rocca.
  1139.  
  1140.    It is illegal to edit, alter, hack, reverse engineer and / or modify
  1141.    any components of Transx or its archive components in any manner.
  1142.  
  1143.    Transx and its encoding and security algorithims are the legal
  1144.    property of Multiboard Communications Centre.  They may not be used
  1145.    in any other program other than Transx without the express written
  1146.    consent of Pete Rocca of Multiboard Communications Centre.
  1147.  
  1148.    This product, concept and design are protected by Canadian copyright
  1149.    laws and international treaty provisions.  If dispute of any issues
  1150.    on legal grounds said above, then governing law of Ontario, Canada
  1151.    will rule.  If you agree to all of the above, then you may use
  1152.    these programs.
  1153.  
  1154.    * REMEMBER THAT REGISTRATION IS QUITE INEXPENSIVE FOR ALL YOU SAVE *
  1155.